package com.education.platform.service;

import com.education.platform.dto.DashboardOverviewDTO;
import com.education.platform.dto.OrderStatsDTO;
import com.education.platform.dto.UserTrendDTO;
import com.education.platform.entity.Statistics;

import java.time.LocalDate;
import java.util.List;

/**
 * 统计服务接口
 *
 * @author education-platform
 * @since 2024-09-27
 */
public interface StatisticsService {

    /**
     * 创建统计记录
     */
    Long createStatistics(Statistics statistics);

    /**
     * 更新统计记录
     */
    void updateStatistics(Long id, Statistics statistics);

    /**
     * 删除统计记录
     */
    void deleteStatistics(Long id);

    /**
     * 根据ID获取统计
     */
    Statistics getStatisticsById(Long id);

    /**
     * 根据日期和类型获取统计
     */
    Statistics getStatisticsByDateAndType(LocalDate statDate, String statType);

    /**
     * 查询日期范围内的统计
     */
    List<Statistics> getStatisticsByDateRange(String statType, LocalDate startDate, LocalDate endDate);

    /**
     * 获取最新的统计
     */
    Statistics getLatestStatistics(String statType);

    /**
     * 保存或更新统计
     */
    void saveOrUpdateStatistics(LocalDate statDate, String statType, Long statValue, String extraData);

    /**
     * 统计总和
     */
    Long sumByTypeAndDateRange(String statType, LocalDate startDate, LocalDate endDate);

    /**
     * 执行每日统计任务
     */
    void executeDailyStatistics();

    /**
     * 统计用户数据
     */
    void statisticsUserData(LocalDate statDate);

    /**
     * 统计订单数据
     */
    void statisticsOrderData(LocalDate statDate);

    /**
     * 统计需求数据
     */
    void statisticsDemandData(LocalDate statDate);
    
    /**
     * 获取Dashboard概览数据
     */
    DashboardOverviewDTO getDashboardOverview();
    
    /**
     * 获取用户增长趋势数据（最近7天）
     */
    UserTrendDTO getUserTrend(Integer days);
    
    /**
     * 获取订单状态统计数据
     */
    OrderStatsDTO getOrderStats();
}

